VM Images

Prerequisites

• Access Level: Admin, Super-admin.
• . Basic VM Interaction
  • View drives (inconsistent, see notes)
  • View drive keys (necessary to share/attach)
  • View hardware/image setups made available to them
  • View own VM configs and configs shared with them
  • View own VM username
  • View anyone's VM username (necessary for sharing VMs)
  • View own VMs and VMs shared with them
• . VM Administration
  • View raw Libvirt volumes (images)
  • Upload raw Libvirt volumes (images)
  • View all VM images
  • Create VM images (from Libvirt volumes)
  • View all VM images
  • Create VM images (from Libvirt volumes)
  • Edit any VM image
  • Delete any VM image
  • View all hardware/image setups in the system
  • Create hardware/image setups
  • Edit hardware/image setups
  • Arbitrarily delete any hardware/image setup
  • View all VM configs in the system
  • Arbitrarily edit any VM config
  • View host machines and hardware information in any Libvirt realm
  • Arbitrarily view logs from any VM

Access VM Images

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the VM Images in the left panel.

View Basic Information of a VM Image

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the VM Images in the left panel.
4. Select the VM Image to view.
5. Click the View button in the top right panel.
6. In the left panel, view the VM image name, hardware setup use, description, realm, capacity,created and last modified date.

View the Hardware Setup Used for a VM Image

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the VM Images in the left panel.
4. Select the VM Image to view the hardware setup.
5. Click the View button in the top right panel.
6. Click the Hardware Setup card in the bottom left panel.
7. In the new left panel, view the hardware setup name, description, realm, user and team availability, creation date, image, cores, memory, used devices and VMs.

Create a New VM Image

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the VM Images in the left panel.
4. Click the Create new VM image button in the top right panel.
5. In the pop-up, enter the VM image name, Libvirt volume, operating system and supported drive formats, the device BUS type, boot options, maximum instances and optional description.
6. Click Create image.

info

Creating a VM image requires you to specify the operating system and supported drive formats.

Add VM Creation Limit in a VM Image

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the VM Images in the left panel.
4. Select the VM image to add VM creation limit.
5. Click the Edit button in the top right panel.
6. In the pop-up, under Maximum instances enter the number of VMs allowed for the VM image.
7. Click Update image.

note

Maximum VM creation limits serve the software licensing restrictions and software compliance as a result.

Set Up VirtIO or SCSI in a New VM Image

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the VM Images in the left panel.
4. Click the Create new VM image button in the top right panel.
5. In the pop-up, enter the Libvirt volume, image name, operating system and supported drive formats.
6. Under BUS type section, select between VirtIO or SCSI BUS type.
7. Click Create image.

tip

For native Libvirt VM images, use VirtIO. For Nutanix-imported VM images, use SCSI, as Windows cannot boot the image.

Edit an Existing VM Image

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the VM Images in the left panel.
4. Select the VM image to edit.
5. Click the Edit button in the top right panel.
6. In the pop-up, edit the VM image name, Libvirt volume, operating system and supported drive formats, the device BUS type, boot options, maximum instances and optional description.
7. Click Update image.

Edit the Operating System of a VM Image

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the VM Images in the left panel.
4. Select the VM image to edit.
5. Click the Edit button in the top right panel.
6. In the pop-up, under Parameters section, select the operating system between Linux, Windows or Unknown/Other.
7. Click Update image.

Edit the Supported Drive Format of a VM Image

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the VM Images in the left panel.
4. Select the VM image to edit.
5. Click the Edit button in the top right panel.
6. In the pop-up, under Parameters section, select the supported drive format as ext4, ntfs, btrfs, xfs, or zfs.
7. Click Update image.

Edit the Boot Options of a VM Image

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the VM Images in the left panel.
4. Select the VM image to edit.
5. Click the Edit button in the top right panel.
6. In the pop-up, under Boot Options, select either Use secure boot (UEFI) or Use legacy boot (BIOS).
7. Click Update image.

Clone an Existing VM Image

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the VM Images in the left panel.
4. Select the VM image to clone.
5. Click the Clone button in the top right panel.
6. In the pop-up, enter the clone name.
7. Click Clone.

note

• Cloning a VM image creates an exact copy with a new name.
• Always choose a unique name for the cloned VM image to distinguish it from the original.

Delete VM Image(s)

bulk-action

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the VM Images in the left panel.
4. Select the VM image(s) to delete.
5. Select the VM image(s) to delete.
6. Click the Delete button in the top right panel.
7. In the pop-up, view the hardware setups that depend on the image(s) to delete.
8. Click the Delete button next to the hardware setup(s) to delete it(them) before deleting its image(s).
9. Once done, click Delete.

note

• Deleting the hardware setups that use a VM image helps prevent data corruption and reduces debugging needs.
• Removing a Libvirt image does not delete the underlying volume; Libvirt images are metadata layers over the actual storage content.